home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 February / CHIPCD_2_2000.iso / software / drivery / Elsa ERAZOR / EZ3_OGLB.EXE / DRVTOOLS / EVIDCTRL.CAB / Layout.txt < prev    next >
Text File  |  1999-11-04  |  10KB  |  287 lines
  1. -------------------------------------------------------------------------
  2.   Layout description for ELSA desktop library
  3.  
  4.   The layout file is a INI-file which consists of three types of sections:
  5.   GLOBAL (unique), WINDOW (unique) and <Control>
  6.  
  7.   All bitmaps are Window-BMP files and could be loaded from a cabinet file
  8.   
  9.   1. [GLOBAL]
  10.      This section identifies the layout file.
  11.      There are following entries in this section:
  12.      - Signature: ID to identify the programm the layout is for
  13.      - Name: (optional) name for the layout
  14.      - Cabfile: (optional) Cabinate file with the used bitmaps
  15.  
  16.     Example: 
  17.  
  18.     [GLOBAL]
  19.     Signature=EVIDCTRL_Layout
  20.     Name=ELSA Metall
  21.     Cabfile=EVidMtl.cab
  22.  
  23.  
  24.   2. [WINDOW]
  25.      This section defines the background dialog for the controls
  26.      There are following entries in this sectio
  27.      - Size: the size of the dialog
  28.      - Bitmap: the background bitmap with the spezified size
  29.      - FramePoints: Number of polygone points for the clipping area
  30.      - FPxxx: (x,y) pair of frame points, where xxx starts with 1 and 
  31.               ends with <framepoints>. Each polygone has to be closed, 
  32.               i.e. the first point and the last point have to be the same.
  33.               Multiple polygones could be defined.
  34.      
  35.     Example: 
  36.     --------
  37.  
  38.     [WINDOW]
  39.     Size=421,120
  40.     Bitmap=background.bmp
  41.     FramePoints=105
  42.     FP1=5,0
  43.     FP2=295,0
  44.     FP3=297,1
  45.     .
  46.     .
  47.     .
  48.     FP103=304,1
  49.     FP104=305,1
  50.     FP105=306,0
  51.  
  52.   3. [<Control>]
  53.     For each control there has to be a section with the control name to
  54.     define the position, size, bitmaps and some extra attributes, depending 
  55.     of the type of the control.
  56.  
  57.     The common entries of all controls are:
  58.     - Pos: (x,y) pair of the left top position of the control
  59.     - Size: (x,y) pair of the size of the control
  60.     - Bitmap: filename with the background or normal state bitmap 
  61.               (i.e. not checked, down, disabled, focus). This entry is requiered 
  62.               in all controls but the text- and the empty-control
  63.     - TransparencyColor: RGB-Value for transparency color in bitmap, 
  64.               hexadecimal (0xBBGGRR) or decimal
  65.  
  66.     a) Button-Control
  67.             A button control is similar to a windows push button and
  68.             could have four states, each with a bitmap 
  69.             State            Section-Entry
  70.             -------------------------------
  71.             neutral (Off)    Bitmap
  72.             down             Down
  73.             focus            Focus
  74.             disabled         Disabled
  75.  
  76.             Excapt the neutral bitmap the other are optional. If a bitmap is 
  77.             missing the neutral bitmap is displayed.
  78.  
  79.             Additional attributs are 
  80.             RepeatDelay:  delay for repeat function
  81.             DownEvent:    pressing the button will generate the event, 
  82.                           not releasing (normal behavior)
  83.              
  84.  
  85.             Example:
  86.             --------
  87.  
  88.             [FILE]
  89.             Pos=6,36
  90.             Size=26,10
  91.             Bitmap=fileOff.bmp
  92.             Down=fileDown.bmp
  93.             Checked=fileOn.bmp
  94.             Disabled=fileDis.bmp
  95.             ;Focus= no focus bitmap
  96.  
  97.  
  98.     b) Check-Control
  99.             A check control is similar to a windows check box and could 
  100.             have five states, each with a bitmap 
  101.             State            Section-Entry
  102.             -------------------------------
  103.             neutral (Off)    Bitmap
  104.             down             Down
  105.             checked          Checked
  106.             focus            Focus
  107.             disabled         Disabled
  108.              
  109.             Excapt the neutral bitmap the other are optional. If a bitmap is 
  110.             missing the neutral bitmap is displayed.
  111.             
  112.             Example:
  113.             --------
  114.             [SELCET]
  115.             Pos=33,36
  116.             Size=26,10
  117.             Bitmap=SelectOff.bmp
  118.             Down=SelectDown.bmp
  119.             Disabled=SelectDis.bmp
  120.             ;Focus= no focus bitmap
  121.  
  122.     c) Slider-Control
  123.             A slider control is similar to a windows slider control and has a 
  124.             background and a slider. The slider could by in normal, focused or 
  125.             diabled state, the bitmaps of the slider have to be smaller than 
  126.             the background bitmap have to be the same size.
  127.  
  128.             Additional attributs are 
  129.             BlinkTime:  (optional) millisecond of changing between normal and 
  130.                         focus slider if selected (has focus)
  131.             Direction:  direction of slider movement
  132.                         right: horizontal slider, low value left, high value right
  133.                         left:  horizontal slider, high value left, low value right
  134.                         down:  vertical slider, low value up, high value down
  135.                         up:    vertical slider, low value down, high value up
  136.  
  137.             SmoothUpdate:Slider movement to cursor (default: 1)
  138.                           0: slider directly at mouse position on mouse button pressed
  139.                           1: slider will move slowly to mouse position as long as 
  140.                              button pressed
  141.                         
  142.             Example:
  143.             --------
  144.             [VOLUME_OUT_LEFT]
  145.             Pos=209,6
  146.             Size=81,12
  147.             Bitmap=VOutL_Bk.bmp
  148.             Slider=SliderDown.bmp
  149.             Focus=Sliderfocus.bmp
  150.             BlinkTime=500
  151.             Direction=right
  152.             TransparencyColor=0xFFFFFF
  153.  
  154.     d) 2D-Slider-Control
  155.             A 2D-slider control controls two values, one horizontal and the other 
  156.             vertcal. It has a background and a slider. The slider could by 
  157.             in normal, focused or diabled state, the bitmaps of the slider have 
  158.             to be smaller than the background bitmap have to be the same size.
  159.  
  160.             Additional attributs are 
  161.             BlinkTime:  (optional) millisecond of changing between normal and 
  162.                         focus slider if selected (has focus)
  163.                         
  164.             SmoothUpdate:Slider movement to cursor (default: 1)
  165.                           0: slider directly at mouse position on mouse button pressed
  166.                           1: slider will move slowly to mouse position as long as 
  167.                              button pressed
  168.             Example:
  169.             --------
  170.             [COLOR]
  171.             Pos=7,79
  172.             Size=34,34
  173.             Bitmap=2DSliderBK.bmp
  174.             Slider=2DSlider.bmp
  175.             Focus=2DSliderf.bmp
  176.             Disabled=2DSliderDis.bmp
  177.             BlinkTime=500
  178.             Clipping=1
  179.             TransparencyColor=0x000000
  180.  
  181.     e) Text-Control
  182.             A text control displays text on a background or a background color.
  183.             
  184.             Additional attributs are 
  185.             Direction:  direction of text
  186.                         right: normal text direction, left to right
  187.                         left:  upside down text (180░)
  188.                         down:  down text (90░ clockwise)
  189.                         up:    up text (270░ clockwise)
  190.             BackgroundColor: RGB-Value for text background, hexadecimal (0xBBGGRR) 
  191.                         or decimal value, can be used instead of 'bitmap' entry
  192.             Font:       font name of text
  193.             FontColor:  color of text
  194.             FontSize:   size of font
  195.             FontWeight: weight of text (100...900)
  196.             FontColor2: alternate font color for blink mode
  197.             BlinkTime:  millisecond of changing between FontColor and FontColor2
  198.             HPosText:   horizontal position of text in display area
  199.                         left:   left aligned
  200.                         center: centered
  201.                         right:  right aligned
  202.             VPosText:   vertical position of text in display area
  203.                         top:    top aligned
  204.                         center: centered
  205.                         bottom: bottom aligned
  206.  
  207.             Example:
  208.             --------
  209.             [STATUS_DISPLAY]
  210.             POS=35,19
  211.             Size=40,15
  212.             Direction=RIGHT
  213.             BackgroundColor=0x000000
  214.             ;Bitmap= not needed
  215.             FontColor=0xEBB200
  216.             Font=ARIAL
  217.             FontSize=11    
  218.             HPosText=left
  219.             VPosText=center
  220.             FontWeight=800
  221.             FontColor2=0x0000FF
  222.             BlinkTime=300
  223.  
  224.     f) Display-Control
  225.             A display control is used to show a value in a graphical way like a
  226.             windows progress bar. It has a background bitmap and a display bitmap.
  227.             The part of display bitmap shown is related to the value, assigned to 
  228.             the control. A stepping rate can be defined.
  229.  
  230.             Additional attributs are 
  231.             Display:    the display (value) bitmap
  232.             Direction:  direction of diplay
  233.                         right: horizontal display, low value left, high value right
  234.                         left:  horizontal display, high value left, low value right
  235.                         down:  vertical display, low value up, high value down
  236.                         up:    vertical display, low value down, high value up
  237.             Step:       stepping rate of display to simulate digital displays, 
  238.                         the display bitmap will only be shown in parts of 'Step' size
  239.  
  240.             Example:
  241.             --------
  242.             [DISPLAY]
  243.             POS=5,30
  244.             Size=182,10
  245.             Bitmap=DisplayBG.BMP
  246.             Display=Display.bmp
  247.             Step=9
  248.             Direction=right
  249.  
  250.     g) Picture-Control
  251.             Control for animation or just displaing a picture
  252.             The defined bitmap could include one or more pictures to display in 
  253.             the defined area (by Pos and Size). The number of pictures included 
  254.             in the bitmap is calculated by the area size and the bitmap size:
  255.             For example, if the display-area has 10x10 pixel and the bitmap 
  256.             40x20 pixel, there are 8 pictures which are successive displayed, 
  257.             using a delay of BlinkTime from left to right and top to bottom:
  258.             -----------------
  259.             | 1 | 2 | 3 | 4 |
  260.             -----------------
  261.             | 5 | 6 | 7 | 8 |
  262.             -----------------
  263.  
  264.             Additional attributs are 
  265.             BlinkTime:  millisecond delay for next picture
  266.  
  267.             Example:
  268.             --------
  269.             [PICTURE]
  270.             POS=150,0
  271.             SIZE=20,20
  272.             Bitmap=PICTURE.BMP
  273.             BlinkTime=100
  274.  
  275.  
  276.  
  277.     h) Empty-Control
  278.             Just a area with position and size
  279.  
  280.             Example:
  281.             --------
  282.             [PREVIEW]
  283.             Pos=311,30
  284.             Size=101,79
  285.  
  286.  
  287.